<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Translating an Application</title>
<meta name="GENERATOR" content="WinCHM">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

</head>

<BODY>
<p>Click <strong>Resources</strong> from the main menu to select specific bundles and languages to edit. Alternatively, all languages or just the default language can be edited directly from the resource summary by clicking the corresponding buttons.</p>
<img src="images/express-editelements.png" alt=Elements in an application" class="centered" />
<p>Before starting a translation, you should read <a href="Understanding.Bundles.and.Elements.html">Understanding Bundles and Elements</a>.</p>

<div class="contents">
  <h2>Contents</h2>
  <ol>
    <li><a href="Editing.RBT.Files.html">Editing RBT Files</a></li>
    <li><a href="#adding">Adding an Element</a></li>
    <li><a href="#bulkadd">Adding Elements in Bulk</a></li>
    <li><a href="#oneclickauto">One Click Automatic Translation</a></li>
    <li><a href="#bulk">Bulk Automatic Translation</a></li>
    <li><a href="#filters">Filters</a></li>
    <li><a href="#reusing">Re-using Resources</a></li>
    <li><a href="#comments">Comments</a></li>
    <li><a href="#incomplete">Incomplete Translations</a></li>
    <li><a href="#shortcut">Shortcut Keys</a></li>
    <li><a href="#variants">Creating variants of existing translations</a></li>
    <li><a href="#poedit">Editing PO Files</a></li>
  </ol>
</div>

<h2>Editing RBT Files</h2>
<p>See <a href="Editing.RBT.Files.html">Editing RBT Files</a>.</p>

<h2><a name="adding">Adding an Element</a></h2>
<p>To add a new element, click <strong>Add</strong>. The element name, bundle name and a translation into the default language are the only compulsory fields.</p>
<img src="images/element-new-express.png" alt="Adding an Element" class="centered" />
<p>The icons underneath the translations for the default language are <strong>Open Full Editor</strong>, <strong>Find similar translations</strong> and <strong>WordNet lookup.</strong>
<p>Clicking the <strong>Open full editor</strong> button next to a field will open a larger window allowing more room when editing text.</p>
<p>The resource used for an element can be changed using the <strong>Resource ID</strong> drop down box. Only resources where a translation into the default language of the application being edited is present are shown, as the default language is required for every element in a bundle.</p>
<p>It may be easier to an element by first searching for an existing resource. Click <strong>Find Resources</strong> in the toolbar, then either select an existing resource or create a new one.</p>
<p><strong>WordNet Lookup</strong> searches <a href="http://wordnet.princeton.edu/">, a word lookup service from Princeton to show a definition of either the selected word or the translation for the default language. Only single words can be looked up.</p>

<h2><a name="bulkadd">Adding Elements in Bulk</a></h2>
<p>Elements can also be added in bulk, saving time when adding multiple elements at once.</p>
<img src="images/bulkadd-express.png" alt="Adding elements in bulk" class="centered" />
<ol>
  <li>From the <strong>View Resources</strong> dialog, select <strong>Element-&gt;Bulk Add Elements</strong> or press <strong>Ctrl+Shift+B</strong>.</li>
  <li>Enter each string from the application being translated on a new line.</li>
</ol>
<p>Each translation entered is added as an element to the selected bundle. If the translation exists as a resource, the existing resource is used. If not, a new resource is created for each element.</p>

<h2><a name="oneclickauto">One Click Automatic Translation</a></h2>
<p>The text for the default language can be quickly translated by clicking the <strong>Translate</strong> button. This uses Google Translate to translate whatever is entered for the default language for the resource being edited.</p>

<h2><a name="bulk">Bulk Automatic Translation</a></h2>
<p>See <a href="Bulk.Automatic.Translation.html">Automatic Translation</a></p>

<h2><a name="filters">Filters</a></h2>
<p>Elements can be filtered by bundle name, element name, comment contents or a translation. This is useful to prevent creating duplicate elements in an application. For example, a filter could be applied to show elements where the English translation contained <em>New</em> to quickly find any existing matching elements.</p>
<p>Click the <strong>Filters</strong> button to show the filters section.</p>

<h2><a name="reusing">Re-using Resources</a></h2>
<p>When adding elements to a bundle, sometimes multiple elements use the same resource. To find the resource quickly, enter part of the translation into one of the language text boxes, <em>Search</em> button.</p>
<p>The <strong>Find Resources</strong> dialog will open, allowing you to search for resources where the translation into a selected languages starts with, ends with or contains a word or phrase.</p>
<p>Eg: If you enter a translation into the box for French, for example, matching translations in French will be shown.</p>
<div class="centered">
  <img src="images/findresource-express-stage1.png" alt="Locate a resource with the Find Resource button" />
  <img src="images/findresource-express.png" alt="Searching for a resource" />
</div>
<p>A list of matching translations will be shown, and clicking one will select it from the <em>Resource ID</em> dropdown box and populate the boxes with available translations.</p>

<h2><a name="comments">Comments</a></h2>
<p>The element comment is optional and can be used to give context to an element such as <em>The save button in the main menu</em> or <em>The window title when exiting</em>. The resource comment is optional and gives context to the resource in general, while each translator's comment gives context to the translation into a particular language. This is never used when generating resources except for the PO format, where it is used to store the meta data for each entry.</p>

<h2><a name="incomplete">Incomplete Translations</a></h2>
<p>When ResourceBlender generates resources, if a translation into the target language is available it is used, otherwise, the default language is used instead. Therefore, if no translation is available you should leave the textbox for that language blank and <strong>not</strong> copy and paste the default language.</p>

<h2><a name="shortcut">Shortcut Keys</a></h2>
<p>When editing, the following shortcut keys are available:</p>
<table class="wikitable">
    <tr>
        <th><strong>Shortcut Key</strong></th>
        <th><strong>Action</strong></th>
    </tr>
    <tr>
        <td>Alt + Left</td>
        <td>Previous element</td>
    </tr>
    <tr>
        <td>Alt + Right</td>
        <td>Next element</td>
    </tr>
    <tr>
        <td>Ctrl + S</td>
        <td>Save and close</td>
    </tr>
    <tr>
        <td>Escape</td>
        <td>Close without saving</td>
    </tr>
    <tr>
        <td>Ctrl + 1 to Ctrl + 9</td>
        <td>Select translation 1 - 9</td>
    </tr>
</table>
<p>Clicking the <strong>Shortcut Keys</strong> icon in the toolbar shows a window with the mapping of each shortcut key.

<h2><a name="variants">Creating variants of existing translations</a></h2>
<p>See <a href="Creating.Variants.html">Creating variants of existing translations</a>.</p>

<h2><a name="poedit">Editing PO Files</a></h2>
<p>See <a href="PO.Format.html#poedit">Editing PO Files</a>.</p>

</BODY>
</html>
